Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Universal Imaging Messages

GXRenderPage

QuickDraw GX sends the GXRenderPage message just prior to the rendering the image of a page. You need to override the GXRenderPage message if you want to perform some task during rendering of each page. Your override of the GXRenderPage message must match the following formal declaration:

OSErr MyRenderPage (gxFormat aFormat, gxShape aShape,
                     gxPageInfoRecord *aPageInfoRecord,
                     void *imageData);

aFormat

The format object for the page.

aShape

The data that belongs on the page in the form of a graphics picture shape.

aPageInfoRecord

A pointer to a page information structure.

imageData

A pointer to imaging-system-specific data.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXImagePage message sends the GXRenderPage message once for each copy of a page. The GXRenderPage message renders a single page into raster, PostScript, or vector format.

You need to override this message if you want to perform some task prior to, during, or after the rendering of each page.

The default implementation of the GXRenderPage message renders one copy of the page, sending messages to relay that information to the specific driver.

SPECIAL CONSIDERATIONS

You never send the GXRenderPage message yourself.

You almost always forward the GXRenderPage message to other message handlers. You can forward the message before or after performing your own tasks.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The page information structure is described on page 4-11.

The GXImagePage message is described in the previous section.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help